﻿<!DOCTYPE html PUBLIC 
    "-//W3C//DTD XHTML 1.0 Strict//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en"><head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title>Документация к "Панель управления пользователя почтового домена"</title>
<link rel="stylesheet" type="text/css" media="screen" href="docs.css" mce_href="docs.css" />
</head>
<body>
<h1>1. Панель управления для пользователя почтового домена</h1>
<h2>1.1. Общий вид панели. Расположение элементов управления</h2>
<p>
Общий вид панели управления для пользователя почтового домена показан на приведенном ниже рисунке.
</p>
<center><img src="images/umain.png"><br><b>Рисунок 1</b></center>
<p>
Панель управления состоит из 3-х частей, панелей.
<ul>
<li>Верхняя панель. Здесь располагаются элементы управления, относящиеся ко всему приложению. И, в частности, "Меню приложения".</li>
<li>Левая панель. Содержит "Меню операций".</li>
<li>Правая панель. "Панель операций". Здесь отображаются рабочие панели, в соответствии с выбранным пунктом меню.</li>    
</ul>
</p>
<h2>1.2. Меню приложения</h2>
<p>Меню приложения содержит следующие элементы.</p>
<table>
<tr><td><b>Домен</b></td><td>Название администрируемого в текущий момент домена.</td></tr>
<tr><td><b>Пользователь</b></td><td>Иия, под которым пользователь вошел в панель управления.</td></tr>
<tr><td><b>Документация</b></td><td>Загрузка и отображение контекстуально зависимой помощи.</td></tr>
<tr><td><b>Подсказки</b></td><td>Кнопка включения/выключения подсказок.</td></tr>
<tr><td><b>Выйти</b></td><td>Завершение работы и выход из приложения.</td></tr>
</table>
<h2>1.3. Меню операций</h2>
<p>В меню операций включены следующие пункты.</p>
<table>
<tr><td style="width:170px; vertical-align:top;"><b>Список адресов отправителей</b></td><td>Редактирование
списка исключений на основе адреса отправителя.<br></td></tr>
<tr><td style="width:170px; vertical-align:top;"><b>События Антиспам защиты</b></td><td>Просмотр журнала 
регистрации событий, связанных с антиспам защитой.<br></td></tr>
<tr><td style="width:170px; vertical-align:top;"><b>События Антивирусной защиты</b></td><td>Просмотр журнала 
регистрации событий, связанных с антивирусной защитой.<br></td></tr>
</table>
<h2>1.4. Панель операций</h2>
<p>
Служит для отображения форм, таблиц и прочего контента, в соответствии с выбранным пунктом меню.
</p><br>
<h1>2. Меню операций</h1>
<a name="bw"></a><h2>2.1. Список адресов отправителей</h2>
<p>
При выборе этого пункта меню на панели операций отображается таблица, как показано на рис.1. 
Здесь вы можете задать список e-mail адресов либо шаблонов адресов отправителей. Если адрес отправителя соответствует одному из 
перечисленных в этом списке адресов или шаблонов, то это сообщение будет обработано особым образом (см.ниже).
</p>
<p>
Назначение столбцов таблицы "Список адресов отправителей" следующее:
</p>
<table>
<tr><td style="width:150px; vertical-align:top;"><strong>ID</strong></td><td>Идентификатор записи. Это уникальное для конкретной списка число, 
которое используется в диагностических сообщениях (например для ссылки на какую-то запись).<br>&nbsp;</td></tr>
<tr><td style="width:150px; vertical-align:top;"><strong>Адрес отправителя</strong></td><td>E-mail адрес отправителя или шаблон адреса.<br>&nbsp;</td></tr>
<tr><td style="width:150px; vertical-align:top;"><strong>Спам</strong></td><td>"Да" - считать все сообщения, полученные с этого адреса спамом. "Нет" - как нормальное сообщение.<br>&nbsp;</td></tr>
<tr><td style="width:150px; vertical-align:top;"><strong>Комментарий</strong></td><td>Этот столбец вы можете совершенно свободно использовать
по собственному усмотрению. Например, дать полную расшифровку того, кто пишет вам с этого адреса, ввести собственную классификацию для удобства поиска и сортировки и т.д.<br>&nbsp;</td></tr>
</table>
Назначение элементов управления для работы с таблицей описано в <a href="customers.html#2">Приложение II. Работа с таблицами.</a><br>
Правила записи и использования E-mail адресов и шаблонов см. <a href="customers.html#3">Приложение III. E-Mail адреса, доменные имена и их шаблоны</a>
<br>&nbsp;
<a name="antispam"></a><h2>2.2. События Антиспам защиты</h2>
<p>
В журнале регистрации событий антиспам защиты регистрируются все события. Наряду с событиями, когда сообщение было идентифицировано как спам, регистрируются
также и события успешного приема сообщения. Каждой строке журнала соответствует одна цепочка "Отправитель - Получатель". Таким образом, если сообщение было
адресовано нескольким получателям одного или нескольких доменов, в журнале будет несколько записей, одно сообщение - несколько цепочек. 
</p>
<p>
Основным элементом представления журнала антиспам защиты является таблица. Назначение столбцов данной таблицы следующее:
</p>
<table>
<tr><td style="width:100px; vertical-align:top;"><strong>ID</strong></td><td>Идентификатор записи. Это уникальное для конкретного журнала число, 
которое используется в диагностических сообщениях (например для ссылки на какую-то запись).<br>&nbsp;</td></tr>
<tr><td style="width:100px; vertical-align:top;"><strong>Время</strong></td><td>Дата и время регистрации события.<br>&nbsp;</td></tr>
<tr><td style="width:100px; vertical-align:top;"><strong>Действие</strong></td><td>Отображает действие, которое выполнил фильтр с сообщением для даной цепочки "Отправитель-Получатель". 
Список действия и пояснения см. <a href="customers.html#1">Приложение I. Типы реакции на спам.</a><br>&nbsp;</td></tr>
<tr><td style="width:100px; vertical-align:top;"><strong>Код</strong></td><td>Код причины, почему фильтр так поступил. Краткая расшифровка кода дается при наведении 
указателя мыши на код.<br>&nbsp;</td></tr>
<tr><td style="width:100px; vertical-align:top;"><strong>Отправитель<strong></td><td>E-Mail адрес отправителя, полученный на этапе SMTP сессии.<br>&nbsp;</td></tr>
<tr><td style="width:100px; vertical-align:top;"><strong>Релей<strong></td><td>Реверсивное(обратное) доменное <a href="appendix.html#4">имя релея</a> Если данный релей не имеет 
записи PTR в системе DNS - фильтр помещает в этом месте IP адрес релея, заключенный в квадратные скобки: "[IP адрес релея]".<br>&nbsp;</td></tr>
<tr><td style="width:100px; vertical-align:top;"><strong>IP адрес<strong></td><td>IP адрес удаленного релея.<br>&nbsp;</td></tr>
<tr><td style="width:100px; vertical-align:top;"><strong>Приветствие<strong></td><td>Это доменное имя удаленного релея, котрым он представляется в начале SMTP сессии.<br>&nbsp;</td></tr>
<tr><td style="width:100px; vertical-align:top;"><strong>SMTP_ID<strong></td><td>Уникальный для принимающего сервера идентификатор сообщения. Или идентификатор, присвоенный 
сервером сообщению на протяжении SMTP сессии.<br>&nbsp;</td></tr>
<tr><td style="width:100px; vertical-align:top;"><strong>Модуль<strong></td><td>Модуль фильтра, который принял окончательное решение.<br>&nbsp;</td></tr>
</table>
Назначение элементов управления для работы с таблицей описано в <a href="customers.html#2">Приложение II. Работа с таблицами.</a>
Толкование некоторых терминов можно найти в <a href="customers.html#4">Приложение IV. Определение терминов</a>

<br>&nbsp;<a name="antivir"></a><h2>2.3. События Антивирусной защиты</h2>
<p>
Наряду с антиспам защитой наши сервера выполняют, также и функцию антивирусной защиты. Проверка сообщений электронной почты проводится двумя антивирусными продуктами. В отличии от 
антиспам защиты никакие дополнительные настройки относительно защищаемого домена не предусмотрены, а в журнале регистрируются только сообщения, в которых зафиксировано вредоносное
содержимое. Инфицированное сообщение не пересылается пользователю ни в коем виде, а уничтожается сразу же по мере обнаружения.
</p>
<p>
Основным элементом представления журнала антивирусной защиты является таблица. Назначение столбцов данной таблицы следующее:
</p>
<table>
<tr><td style="width:100px; vertical-align:top;"><strong>ID</strong></td><td>Идентификатор записи. Это уникальное для конкретного журнала число, 
которое используется в диагностических сообщениях (например для ссылки на какую-то запись).<br>&nbsp;</td></tr>
<tr><td style="width:100px; vertical-align:top;"><strong>Время</strong></td><td>Дата и время регистрации события.<br>&nbsp;</td></tr>
<tr><td style="width:100px; vertical-align:top;"><strong>Отправитель<strong></td><td>E-Mail адрес отправителя, полученный на этапе SMTP сессии.<br>&nbsp;</td></tr>
<tr><td style="width:100px; vertical-align:top;"><strong>ID сообщения<strong></td><td>Идентификатор сообщения. Если он отсутствует в заголовке письма, то в журнал помещается значение "UNKNOWN"<br>&nbsp;</td></tr>
<tr><td style="width:100px; vertical-align:top;"><strong>Причина<strong></td><td>Столбец содержит условное обозначение вредоносного контента в классификации обнаружевшего его антивирусного
программного обеспечения<br>&nbsp;</td></tr>
</table>
Назначение элементов управления для работы с таблицей описано в <a href="customers.html#2">Приложение II. Работа с таблицами.</a>
Толкование некоторых терминов можно найти в <a href="customers.html#4">Приложение IV. Определение терминов</a>

<br>&nbsp;
<h1>3. Приложения</h1>
<a name="1"></a><h2>Приложение I. Типы реакции на спам</h2>
<p>
Действие (реакция) фильтра на факт классификации сообщения как "Спам" задается на трех уровнях.
Перечислим эти уровни в порядке убывания приоритета.
</p>
<table>
<tr><td style="width:170px; vertical-align:top;"><b>Уровень пользователя</b></td><td>Если реакция на спам задана для конкретного пользователя
домена, то это указание имеет самый высокий приоритет. Реакция на спам уровня пользователя может задаваться администратором почтового домена для каждого 
конкретного пользователя отдельно.<br></td></tr>
<tr><td style="width:170px; vertical-align:top;"><b>Уровень домена</b></td><td>Если для пользователя домена не задана конкретный тип реакции на спам,
(По умолчанию) то будет использован тип указанный для домена вцелом. Реакция на спам уровня домена, также задается администратором почтового домена.
<br></td></tr>
<tr><td style="width:170px; vertical-align:top;"><b>Уровень фильтра</b></td><td>Используется фильтром только в том случае, если реакция на спам не была задана
на двух более высоких уровнях. Этот тип устанавливается администратором фильтра и как правило установлен в значение "Отвергнуть сообщение".<br></td></tr>
</table>
<p>
При настройке можно задать следующие типы реакции на спам:
</p>
<table>
<tr><td style="width:170px; vertical-align:top;"><b>По умолчанию</b></td><td>В этом случае будет использована настройка более низкого уровня. См. предыдущий параграф.<br></td></tr>
<tr><td style="width:150px; vertical-align:top;"><b>Принять</b></td><td>При выборе этого типа реакции фильтр кроме регистрации факта получения ничего не делает.
Фактически это аналогично отключению фильтра для конкретного пользователя, либо домена вцелом.<br></td></tr>
<tr><td style="width:170px; vertical-align:top;"><b>Перенаправить/Маркировать</b></td><td>Этот тип реакции указывает, что сообщение опознанное как "Спам" должно быть 
принято, но в последующем либо маркировано и доставлено получателю, либо перенаправлено на конкретно указанный (выделенный) адрес в том же домене. Адрес для пересылки
спама может быть задан администратором почтового домена.<br></td></tr>
<tr><td style="width:170px; vertical-align:top;"><b>Отвергнуть</b></td><td>В даном случае предусматривается, что спам-сообщение должно быть отвергнуто. Это значит, что
целевой получатель сообщения никак не будет информирован о попытке доставки сообщения. А отправитель сообщения может получить уведомление, о том, что его сообщение
классифицировано как "Спам"<br></td></tr>
</table>

<a name="2"></a><h2>Приложение II. Работа с таблицами</h2>
<p>
    Большинство операций по настройке фильтра связано с редактированием различных списков. В данном приложении эти списки представлены в виде таблиц. 
Таблица содержит непосредственно саму таблицу ( заголовок, заголовки столбцов, столбцы, строки ), верхнюю панель инструментов ( панель операций ), панель навигации,
совмещенную в нижней панелью инструментов и панель фильтра. 
</p>
<p>
    Типичный вид таблицы показан на рис.2. Рассмотрим более детально ее составляющие.
</p>
<center><img src="images/bw.png"><br><b>Рисунок 2</b></center>
<h3>Панель инструментов (Операции)</h3>
<p>
Расположена в верхней части таблицы, над заголовками столбцов. Содержит следующие кнопки.
</p>
<table>
<tr><td style="width:100px; vertical-align:top;"><b>Добавить</b></td><td>Добавление в таблицу новой записи.</td></tr>
<tr><td style="width:100px; vertical-align:top;"><b>Изменить</b></td><td>Изменить, отредактировать существующую запись.</td></tr>
<tr><td style="width:100px; vertical-align:top;"><b>Удалить</b></td><td>Удалить одну или несколько записей.</td></tr>
<tr><td style="width:100px; vertical-align:top;"><b>Экспорт</b><td>Экспорт таблицы в Excel файл.</td></tr>
<tr><td style="width:100px; vertical-align:top;"><b>Импорт</b></td><td>Импорт таблицы из Excel файла. См.<a href="customers.html#10">Формат и структура файла импорта.</a></td></tr>
<tr><td style="width:100px; vertical-align:top;"><b>Применить</b></td><td>Указывает фильтру принять в работу все сделанные изменения.</td></tr>
</table>

<h3>Панель инструментов (Управление отображением)</h3>
<p>
Совмещена с панелью навигации и расположена в самой нижней части таблицы, слева. Содержит следующие кнопки.
</p>
<table>
<tr><td style="width:100px; vertical-align:top;"><strong>Обновить</strong></td><td>Обновить отображение таблицы.</td></tr>
<tr><td style="width:100px; vertical-align:top;"><strong>Столбцы</strong></td><td>Выбор столбцов для показа.</td></tr>
<tr><td style="width:100px; vertical-align:top;"><strong>Фильтр</strong></td><td>Включить/Выключить панель фильтра. 
ЗАМЕЧАНИЕ.Выключение панели фильтра не удаляет ранее установленного фильтра.</td></tr>
<tr><td style="width:100px; vertical-align:top;"><strong>Сохранить</strong><td>Сохранить настройки отображения таблицы. Сохранению подлежат следующие параметры: перечень отображаемых столбцов,
их порядок следования, ширина, столбец и направление сортировки, установленное для отображения количество строк таблицы, текущая страница, состояние панели фильтра (Вкл./Выкл.).
Эти данные сохраняются на сервере и будут восстановлены при последующих входах в систему администрирования.</td></tr>
</table>
<p>
<h3>Панель навигации по списку</h3>
    Расположена в самой нижней части таблицы, посредине. Содержит следующие элементы в порядке их следования слева-направо.
<ul>
<li>Кнопка перехода на первую страницу списка.</li>
<li>Кнопка перехода на предидущую страницу списка.</li>
<li>Элемент ввода номера страницы для прямого доступа к странице.</li>
<li>Кнопка перехода на следующую страницу списка.</li>
<li>Кнопка перехода на последнюю страницу списка.</li>
<li>Элемент выбора количества отображаемых строк на странице (таблице).</li>
</ul>
</p>
<p>
<h3>Панель фильтра</h3>
Служит для отбора записей в списке для отображения в таблице и допустима не более чем по двум, одновременно заданым параметрам. Алгоритм отбора записей можно представить в следующем виде:<br>
<br>
<code>ПАРАМЕТР1 Содержит "Значение1" [ И [ ПАРАМЕТР2 Содержит "Значение2"]]</code><br>
<br>
Символы  "[" и "]" используются для показа необязательной части условия фильтра.
</p><p>
<h3>Неочевидные особенности, возможности</h3>
    Ниже приведен список основных неочевидных, на наш взгляд, особенностей и возможностей при работе с таблицей.
<ul>
<li><strong>Редактировать</strong> запись (если это предусмотрено для конкретной таблицы) можно либо пометив ее и нажав кнопку "Изменить", либо сделать двойной щелчек мышью на записи. При этом запись будет 
переведена в режим "строчного" редактирования.</li>
<li><strong>Широну колонки</strong> можно изменить наведя указатель мыши на разделитель колонок в заголовке и нажав левую кнопку. При перемещении в таком положении указателя мыши будет
изменяться ширина соседствующих колонок.</li>
<li><strong>Расположение колонки</strong> в таблице можно изменить наведя указатель мыши на заголовок колонки и нажав левую кнопку. При перемещении влево/вправо указателя мыши будет
изменено расположение колонки в таблице.</li>
<li><strong>Порядок сортировки</strong> в таблице можно изменить наведя указатель мыши на заголовок выбраной для сортировки колонки и щелкнув по левой кнопке мыши.
Повторный щелчек выполнит переключение сортировки по возрастанию/убыванию.</li>
</ul>
</p>
<br><a name="3"></a><h2>Приложение III. E-Mail адреса, доменные имена и их шаблоны</h2>
<p>
Требования к записи E-Mail адресов, доменных имен, подсетей в CIDR нотации описаны в соответствующих документах
<a target="_blank" href="http://tools.ietf.org/html/">RFC</a> и на их рассмотрении мы
останавливаться не будем. Здесь же, мы рассмотрим используемое в приложении понятие шаблона e-mail адреса, доменного имени и то, как данный шаблон интерпретируется фильтром.
</p>
<p>
Как известно, E-Mail адрес имеет вид:<code> local-part@example.domain.com</code><br>
<dl>
<dt>Здесь:</dt>
    <dd><code> local-part </code>- Локальная часть адреса</dd>
    <dd><code>example.domain.com</code> - доменное имя</dd>
</dl>
Запись доменного имени аналогична и для понятий домен, имя релея.
</p>
<p>
Шаблоны предполагают наличие метасимволов. В нашем приложении этими метасимволами являются:
</p>
<table>
<tr><td style="width:20px; vertical-align:top;"><strong>!</strong></td><td>Обозначает наличие в этом месте "цифры".</td></tr>
<tr><td style="width:20px; vertical-align:top;"><strong>*</strong></td><td>Обозначает наличие в этом месте "буквы".</td></tr>
<tr><td style="width:20px; vertical-align:top;"><strong>?</strong></td><td>В этом месте может присутствовать любой символ.</td></tr>
</table>
<h3>Шаблоны E-Mail адресов</h3>
<p>При получении очередного сообщения фильтр сравнивает соответствующие этому сообщению адреса со списками исключений, например списком "Белых адресов". Это сравнениение происходит
следующим образом.</p>
<p>Если запись адреса в списке содержит знак "@" и ему предшествует хотя бы один символ, то сравнение идет посимвольно. Т.е. запись в списке соответствует анализируемому адресу только
в том случае, если они полностью совпадают ( без учета регистра).</p>
<p>Если запись адреса в списке начинается со знака "@" или этот знак вообще отсутствует, то это запись шаблона и сравнение ведется начиная с конца и с учетом метасимволов.</p>
<p>Таким образом, записи в списке исключений: <code>user.name@example.company.com</code> соответствует только адрес: user.name@example.company.com.</p>
<p>Для шаблонов же возможны множественные значения. Например:<br>
<dl>
<dt>Шаблону <code>@example.company.com</code> будут соответствовать адреса</dt>
    <dd><code>a@example.company.com</code></dd>
    <dd><code>qwe-1.234.rty.asdfgh.zxcv1_0123@example.company.com</code></dd>
    <dd><code>Здесь_может_быть_все_что_угодно@example.company.com</code></dd>
<dt>Шаблону <code>.company.com</code> будут соответствовать адреса</dt>
    <dd><code>any_local_part@any-subdomain-1.company.com</code></dd>
    <dd><code>any_local_part@any-subdomain-2.company.com</code></dd>
    <dd><code>Здесь_может_быть_все_что_@угодно.company.com</code></dd>
<dt>Шаблону <code>@office-!!.company.com</code> будут соответствовать адреса</dt>
    <dd><code>any_local_part@office-01.company.com</code></dd>
    <dd><code>any_local_part@office-02.company.com</code></dd>
    <dd><code>any_local_part@office-99.company.com</code></dd>
</dl>
</p>

<br>&nbsp;<a name="4"></a><h2>Приложение IV. Определение терминов</h2>
<p>
Для большинства используемых в данном документе терминов можно найти толкование на сайте <a target="_blank" href="http://ru.wikipedia.org/wiki/">WikiPedia</a>,
строгое их описание можно найти в документах <a target="_blank" href="http://tools.ietf.org/html/">RFC(Request For Comments)</a>. Мы же, дадим краткое описание
некоторых, используемых в нашем толковании терминов.
</p>
<table>
<tr><td style="width:170px; vertical-align:top;"><b>Имя релея</b></td><td>Это доменнон имя <a target="_blank" href="http://ru.wikipedia.org/wiki/Релей">релея (промежуточного сервера)</a>,
определяемое на основе <a target="_blank" href="http://ru.wikipedia.org/wiki/Обратный_запрос_DNS">PTR записи</a> в системе 
<a target="_blank" href="http://ru.wikipedia.org/wiki/DNS">DNS</a>.<br>&nbsp;</td></tr>
<tr><td style="width:170px; vertical-align:top;"><b>SMTP сессия</b></td><td>Это совокупность обмена последовательностями "Команда"-"Ответ" по протоколу <a target="_blank" href="http://ru.wikipedia.org/wiki/SMTP">
SMTP</a> между серверами, учавствующими в процессе передачи сообщений электронной почты на протяжении одного TCP/IP соединения. В процессе SMTP сессии может быть передано одно
или несколько сообщений электронной почты. С каждым сообщением асоциирован один адрес отправителя и один или несколько адресов получателя.<br>&nbsp;</td></tr>
<tr><td style="width:170px; vertical-align:top;"><b>Отправитель</b></td><td>E-Mail адрес отправителя почтового сообщения, полученный от удаленного релея, в процессе передачи сообщения. 
В общем случае этот адрес не обязательно совпадает с отображаемым в письме адресом поля "От: "(From:), которое содержится в заголовке сообщения. Часто этот адрес в самом сообщении 
(его заголовке) никак не фиксируется и его наличие там зависит от применяемого программного обеспечения и его настройки. В сообщениях, прошедших через наши сервера этот адрес
зафиксирован в поле "X-Envelope-From:" заголовка сообщения.<br>&nbsp;</td></tr>
<tr><td style="width:170px; vertical-align:top;"><b>Получатель</b></td><td>E-Mail адрес получателя почтового сообщения, полученный от удаленного релея, в процессе передачи сообщения. 
В общем случае этот адрес не обязательно совпадает с отображаемым в письме адресом поля "Кому: "(To:), которое содержится в заголовке сообщения. Часто этот адрес в самом сообщении 
(его заголовке) никак не фиксируется и его наличие там зависит от применяемого программного обеспечения и его настройки. В сообщениях, прошедших через наши сервера этот адрес
зафиксирован в поле "X-Envelope-To:" заголовка сообщения.<br>&nbsp;</td></tr>
</table>

<br><a name="10"></a><h2>Приложение V. Формат и структура файла импорта</h2>
<p>
При импорте списков из клиентского файла в базу данных сервера поддерживаются следующие форматы файлов: Excel5, Excel2003XML, Excel2007.<br>
ЗАМЕЧАНИЕ. Экспорт выполняется в формате Excel5.<br>
Для примера на рис.3 показана структура файла для импорта в "Список адресов отправителей".
</p>
<center><img src="images/uimport.png"><br><b>Рисунок 3</b></center>
<p>
Что здесь важно? Прежде всего формат и содержание заголовка таблицы. Положение заголовка можно изменять как по горизонтали так и по вертикали.
Все, что находится непосредственно под заголовком воспринимается как содержимое для импорта. Все, что располагается не непосредственно под заголовком при импорте отбрасывается. 
Игнорируются также, пустые строки под заголовком, как например строки 11 и 14 на показанном рисунке.
</p>

</body>
</html>
